home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / programming / c / gcc263-utildoc.lha / gnu / man / man1 / nm.1 < prev    next >
Encoding:
Text File  |  1994-12-19  |  6.8 KB  |  265 lines
  1.  
  2.  
  3.  
  4. nm(1)                 GNU Development Tools                 nm(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        nm - list symbols from object files.
  9.  
  10.  
  11. SSYYNNOOPPSSIISS
  12.        nnmm     [--aa|----ddeebbuugg--ssyymmss] [--gg|----eexxtteerrnn--oonnllyy] [--BB]
  13.               [--CC|----ddeemmaannggllee] [--DD|----ddyynnaammiicc] [--ss|----pprriinntt--aarrmmaapp]
  14.               [--oo|----pprriinntt--ffiillee--nnaammee] [--nn|----nnuummeerriicc--ssoorrtt]
  15.               [--pp|----nnoo--ssoorrtt] [--rr|----rreevveerrssee--ssoorrtt] [----ssiizzee--ssoorrtt]
  16.               [--uu|----uunnddeeffiinneedd--oonnllyy] [----hheellpp] [----vveerrssiioonn] [--tt
  17.               _r_a_d_i_x|----rraaddiixx==_r_a_d_i_x] [--PP|----ppoorrttaabbiilliittyy] [--ff
  18.               _f_o_r_m_a_t|----ffoorrmmaatt==_f_o_r_m_a_t] [----ttaarrggeett==_b_f_d_n_a_m_e]
  19.               [_o_b_j_f_i_l_e...]
  20.  
  21. DDEESSCCRRIIPPTTIIOONN
  22.        GNU nnmm lists the symbols from object files _o_b_j_f_i_l_e.  If no
  23.        object files are given as arguments, nnmm assumes `aa..oouutt'.
  24.  
  25.  
  26. OOPPTTIIOONNSS
  27.        The  long and short forms of options, shown here as alter-
  28.        natives, are equivalent.
  29.  
  30.  
  31.        --AA
  32.  
  33.        --oo
  34.  
  35.        ----pprriinntt--ffiillee--nnaammee
  36.               Precede each symbol by the name of the  input  file
  37.               where it was found, rather than identifying the in-
  38.               put file once only before all of its symbols.
  39.  
  40.  
  41.        --aa
  42.  
  43.        ----ddeebbuugg--ssyymmss
  44.               Display debugger-only symbols; normally  these  are
  45.               not listed.
  46.  
  47.  
  48.        --BB     The  same  as  ----ffoorrmmaatt==bbssdd (for compatibility with
  49.               the MIPS nnmm).
  50.  
  51.  
  52.        --CC
  53.  
  54.        ----ddeemmaannggllee
  55.               Decode (_d_e_m_a_n_g_l_e) low-level symbol names into user-
  56.               level  names.   Besides removing any initial under-
  57.               score prepended by the system, this makes C++ func-
  58.               tion names readable.
  59.  
  60.  
  61.  
  62.  
  63.  
  64. cygnus support           5 November 1991                        1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. nm(1)                 GNU Development Tools                 nm(1)
  71.  
  72.  
  73.        --DD
  74.  
  75.        ----ddyynnaammiicc
  76.               Display  the dynamic symbols rather than the normal
  77.               symbols.  This is only meaningful for  dynamic  ob-
  78.               jects, such as certain types of shared libraries.
  79.  
  80.  
  81.        --ff _f_o_r_m_a_t
  82.               Use the output format _f_o_r_m_a_t, which can be ``bsd'',
  83.               ``sysv'', or ``posix''.   The  default  is  `bsd''.
  84.               Only  the first character of _f_o_r_m_a_t is significant;
  85.               it can be either upper or lower case.
  86.  
  87.  
  88.        --gg
  89.  
  90.        ----eexxtteerrnn--oonnllyy
  91.               Display only external symbols.
  92.  
  93.  
  94.        --nn
  95.  
  96.        --vv
  97.  
  98.        ----nnuummeerriicc--ssoorrtt
  99.               Sort symbols numerically by  their  addresses,  not
  100.               alphabetically by their names.
  101.  
  102.  
  103.        --pp
  104.  
  105.        ----nnoo--ssoorrtt
  106.               Don't bother to sort the symbols in any order; just
  107.               print them in the order encountered.
  108.  
  109.  
  110.        --PP
  111.  
  112.        ----ppoorrttaabbiilliittyy
  113.               Use the POSIX.2 standard output format  instead  of
  114.               the default format.  Equivalent to ``-f posix''.
  115.  
  116.  
  117.        --ss
  118.  
  119.        ----pprriinntt--aarrmmaapp
  120.               When  listing symbols from archive members, include
  121.               the index: a mapping (stored in the archive  by  aarr
  122.               or  rraannlliibb) of what modules contain definitions for
  123.               what names.
  124.  
  125.  
  126.        --rr
  127.  
  128.  
  129.  
  130. cygnus support           5 November 1991                        2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. nm(1)                 GNU Development Tools                 nm(1)
  137.  
  138.  
  139.        ----rreevveerrssee--ssoorrtt
  140.               Reverse the sense of the sort (whether  numeric  or
  141.               alphabetic); let the last come first.
  142.  
  143.  
  144.        ----ssiizzee--ssoorrtt
  145.               Sort  symbols by size.  The size is computed as the
  146.               difference between the value of the symbol and  the
  147.               value  of  the  symbol  with the next higher value.
  148.               The size of the symbol is printed, rather than  the
  149.               value.
  150.  
  151.  
  152.        --tt _r_a_d_i_x
  153.  
  154.        ----rraaddiixx==_r_a_d_i_x
  155.               Use _r_a_d_i_x as the radix for printing the symbol val-
  156.               ues.  It must be ``d'' for decimal, ``o''  for  oc-
  157.               tal, or ``x'' for hexadecimal.
  158.  
  159.  
  160.        ----ttaarrggeett==_b_f_d_n_a_m_e
  161.                Specify an object code format other than your sys-
  162.               tem's default format.  See oobbjjdduummpp(11), for informa-
  163.               tion on listing available formats.
  164.  
  165.  
  166.        --uu
  167.  
  168.        ----uunnddeeffiinneedd--oonnllyy
  169.               Display  only  undefined symbols (those external to
  170.               each object file).
  171.  
  172.  
  173.        --VV
  174.  
  175.        ----vveerrssiioonn
  176.               Show the version number of nnmm and exit.
  177.  
  178.  
  179.        ----hheellpp Show a summary of the options to nnmm and exit.
  180.  
  181.  
  182. SSEEEE AALLSSOO
  183.        `bbiinnuuttiillss' entry in iinnffoo; _T_h_e _G_N_U _B_i_n_a_r_y _U_t_i_l_i_t_i_e_s, Roland
  184.        H. Pesch (October 1991); aarr(11), oobbjjdduummpp(11), rraannlliibb(11).
  185.  
  186.  
  187.  
  188. CCOOPPYYIINNGG
  189.        Copyright (c) 1991 Free Software Foundation, Inc.
  190.  
  191.        Permission  is  granted  to  make  and distribute verbatim
  192.        copies of this manual provided the  copyright  notice  and
  193.  
  194.  
  195.  
  196. cygnus support           5 November 1991                        3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. nm(1)                 GNU Development Tools                 nm(1)
  203.  
  204.  
  205.        this permission notice are preserved on all copies.
  206.  
  207.        Permission is granted to copy and distribute modified ver-
  208.        sions of this manual under  the  conditions  for  verbatim
  209.        copying,  provided  that the entire resulting derived work
  210.        is distributed under the  terms  of  a  permission  notice
  211.        identical to this one.
  212.  
  213.        Permission  is granted to copy and distribute translations
  214.        of this manual into another language, under the above con-
  215.        ditions for modified versions, except that this permission
  216.        notice may be included in  translations  approved  by  the
  217.        Free  Software  Foundation  instead of in the original En-
  218.        glish.
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. cygnus support           5 November 1991                        4
  263.  
  264.  
  265.